home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmnscomp.z / pmnscomp
Encoding:
Text File  |  2002-10-03  |  7.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))                                                        PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnnssssccccoooommmmpppp - compile an ASCII performance metrics namespace into binary
  10.      format.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ppppmmmmnnnnssssccccoooommmmpppp [----dddd] [----ffff] [----nnnn _n_a_m_e_s_p_a_c_e] [----vvvv _v_e_r_s_i_o_n] _o_u_t_f_i_l_e
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmnnnnssssccccoooommmmpppp compiles a Performance Metrics Name Space (PMNS) in ASCII format
  17.      into a more efficient binary representation.  ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) is able
  18.      to load this binary representation significantly faster than the
  19.      equivalent ASCII representation.
  20.  
  21.      If _o_u_t_f_i_l_e already exists ppppmmmmnnnnssssccccoooommmmpppp will exit without overwriting it.
  22.  
  23.      By convention, the name of the compiled namespace is that of the root
  24.      file of the ASCII namespace, with ....bbbbiiiinnnn appended.  For example, the root
  25.      of the default PMNS is a file named rrrrooooooootttt and the compiled version of the
  26.      entire namespace is rrrrooooooootttt....bbbbiiiinnnn.
  27.  
  28.      The options are;
  29.  
  30.      ----dddd   By default the PMNS to be compiled is expected to contain at most
  31.           one name for each unique Performance Metric Id (PMID).  The ----dddd
  32.           option relaxes this restriction and allows the compilation of a PMNS
  33.           in which multiple names may be associated with a single PMID.
  34.           Duplicate names are useful when a particular metric may be logically
  35.           associated with more than one group of related metrics, or when it
  36.           is desired to create abbreviated aliases to name a set of frequently
  37.           used metrics.
  38.  
  39.      ----ffff   Force overwriting of an existing _o_u_t_f_i_l_e if it already exists.
  40.  
  41.      ----nnnn   Normally ppppmmmmnnnnssssccccoooommmmpppp operates on the default PMNS, however if the ----nnnn
  42.           option is specified an alternative namespace is loaded from the file
  43.           _n_a_m_e_s_p_a_c_e.
  44.  
  45.      ----vvvv   By default, ppppmmmmnnnnssssccccoooommmmpppp writes a version 0000 compiled namespace, which is
  46.           compatible with versions of PCP before PCP2.0.  If _v_e_r_s_i_o_n is 1111 then
  47.           ppppmmmmnnnnssssccccoooommmmpppp will write a version 1111 namespace which is compatible with
  48.           PCP2.0 or later.  Note that PCP version 2.0 or later can handle both
  49.           versions but PCP versions prior to PCP 2.0 can only handle version 0000
  50.           compiled namespaces.
  51.  
  52.      The default input PMNS is found in the file $_P_C_P__V_A_R__D_I_R/_p_m_n_s/_r_o_o_t unless
  53.      the environment variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is set, in which case the value is
  54.      assumed to be the pathname to the file containing the default input PMNS.
  55.  
  56. CCCCAAAAVVVVEEEEAAAATTTT
  57.      Once the writing of the new _o_u_t_f_i_l_e has begun, the signals SIGINT, SIGHUP
  58.      and SIGTERM will be ignored to protect the integrity of the new file.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))                                                        PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))
  71.  
  72.  
  73.  
  74. FFFFIIIILLLLEEEESSSS
  75.      $_P_C_P__V_A_R__D_I_R/_p_m_n_s/*
  76.                default PMNS specification files
  77.      $_P_C_P__V_A_R__D_I_R/_p_m_n_s/_r_o_o_t._b_i_n
  78.                compiled version of the default PMNS, when the environment
  79.                variable PPPPMMMMNNNNSSSS____DDDDEEEEFFFFAAAAUUUULLLLTTTT is unset
  80.      $_P_C_P__V_A_R__D_I_R/_p_m_n_s/_s_t_d_p_m_i_d
  81.                some standard macros for PMID generation
  82.  
  83. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  84.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  85.      file and directory names used by PCP.  On each installation, the file
  86.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  87.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  88.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  89.  
  90. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.      ppppmmmmnnnnssssaaaadddddddd(1), ppppmmmmnnnnssssddddeeeellll(1), ppppmmmmnnnnssssmmmmeeeerrrrggggeeee(1), PPPPMMMMAAAAPPPPIIII(3), ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3),
  92.      ppppccccpppp....ccccoooonnnnffff(4), ppppccccpppp....eeeennnnvvvv(4) and ppppmmmmnnnnssss(4).
  93.  
  94. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  95.      Cannot open ``xyz'' - the filename for the root of the PMNS that was
  96.      passed to ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) is bogus.
  97.  
  98.      Illegal PMID - either one of the three PMID components (see ppppmmmmnnnnssss(4)) is
  99.      not an integer, or the value for one of the components is negative, or
  100.      too large.
  101.  
  102.      Expected ... - specific syntax errors when a particular type of lexical
  103.      symbol was expected and not found; the messages are intended to be self-
  104.      explanatory.
  105.  
  106.      Internal botch - implementation problem for the parser ...
  107.  
  108.      Duplicate name ``abc'' in subtree for ``pqr.xyz'' - for each non-leaf
  109.      node, the names of all immediate descendents must be unique.
  110.  
  111.      No name space entry for ``root'' - the special non-leaf node with a
  112.      pathname of ``root'' defines the root of the PMNS, and must appear
  113.      somewhere in the PMNS specification.
  114.  
  115.      Multiple name space entries for ``root'' - more than one ``root'' node
  116.      does not make sense!
  117.  
  118.      Disconnected subtree (``abc.xyz.def'') in name space - the pathname for
  119.      this non-leaf node does not correspond to any pathname in the PMNS, hence
  120.      this non-leaf node is ``orphaned'' in the PMNS.
  121.  
  122.      Cannot find definition for non-terminal node ``xyz'' in name space - a
  123.      non-terminal node is named as part of its parent's specification, but is
  124.      never defined.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))                                                        PPPPMMMMNNNNSSSSCCCCOOOOMMMMPPPP((((1111))))
  137.  
  138.  
  139.  
  140.      Duplicate metric id (xxx) in name space for metrics ``abc'' and ``xyz'' -
  141.      each PMID must be unique across the PMNS.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.